Obtener Campañas Activas

curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1?datePreset=last_7d&accountId=act_123456789&showOnlyActives=false" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "120200000000001",
      "name": "Campaña Verano 2026",
      "status": "ACTIVE",
      "lifetime_budget": "5000000",
      "budget_remaining": "2000000",
      "start_time": "2026-01-01T00:00:00Z",
      "stop_time": "2026-06-30T23:59:59Z",
      "sales_totales": 5,
      "insights": { "data": [] },
      "ads": { "data": [] }
    }
  ],
  "totalSales": 42,
  "totalSpend": 1500.75,
  "totalQuotations": 18,
  "next": null
}

{
  "message": "No se encontró una empresa con ese id"
}

GET

empresas

campaigns

{businessId}

curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1?datePreset=last_7d&accountId=act_123456789&showOnlyActives=false" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "120200000000001",
      "name": "Campaña Verano 2026",
      "status": "ACTIVE",
      "lifetime_budget": "5000000",
      "budget_remaining": "2000000",
      "start_time": "2026-01-01T00:00:00Z",
      "stop_time": "2026-06-30T23:59:59Z",
      "sales_totales": 5,
      "insights": { "data": [] },
      "ads": { "data": [] }
    }
  ],
  "totalSales": 42,
  "totalSpend": 1500.75,
  "totalQuotations": 18,
  "next": null
}

{
  "message": "No se encontró una empresa con ese id"
}

Retorna las campañas de Meta Ads vinculadas a un negocio, junto con totales de gasto (totalSpend), ventas (totalSales) y cotizaciones (totalQuotations) para el período solicitado. Solo retorna campañas que tengan al menos un anuncio con gasto, ventas o cotizaciones.

Autenticación

Requiere el encabezado x-api-key con el App Key del negocio. Consulta Autenticación.

Parámetros de ruta

number

required

ID del negocio cuyas campañas se desean obtener.

Parámetros de consulta

string

required

Período predefinido. Valores aceptados: today, yesterday, last_7d, last_30d, this_month, maximum.

string

required

ID de la cuenta publicitaria de Meta. Obténlo desde [Obtener Cuentas Publicitarias](/Campañas meta/obtener-cuentas-publicitarias).

string

Fecha de inicio en formato ISO 8601. Usada para filtrar ventas y cotizaciones.

string

Fecha de fin en formato ISO 8601. Usada para filtrar ventas y cotizaciones.

boolean

Si es true, filtra y devuelve solo las campañas con estado activo. Por defecto false.

Respuesta

array

Lista de campañas de Meta Ads.

Show Objeto MetaCampaign

string

ID de la campaña en Meta.

string

Nombre de la campaña.

string

Estado de la campaña (ej. ACTIVE, PAUSED).

string

Presupuesto total de vida de la campaña en centavos.

string

Presupuesto restante en centavos.

string

Fecha de inicio en formato ISO 8601.

string

Fecha de fin en formato ISO 8601.

number

Total de ventas de todos los anuncios de la campaña.

object

Métricas de rendimiento de la campaña.

object

Anuncios asociados a la campaña.

number

Total de ventas generadas en el período.

number

Gasto total en el período.

number

Total de cotizaciones generadas en el período.

string | null

Cursor de paginación para obtener la siguiente página de campañas. null si no hay más resultados.

curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1?datePreset=last_7d&accountId=act_123456789&showOnlyActives=false" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "120200000000001",
      "name": "Campaña Verano 2026",
      "status": "ACTIVE",
      "lifetime_budget": "5000000",
      "budget_remaining": "2000000",
      "start_time": "2026-01-01T00:00:00Z",
      "stop_time": "2026-06-30T23:59:59Z",
      "sales_totales": 5,
      "insights": { "data": [] },
      "ads": { "data": [] }
    }
  ],
  "totalSales": 42,
  "totalSpend": 1500.75,
  "totalQuotations": 18,
  "next": null
}

{
  "message": "No se encontró una empresa con ese id"
}

Plantillas de Mensajes

Chats

Campañas

Reporte Compartido

Campañas Meta

Ordenes

Autenticación

Parámetros de ruta

Parámetros de consulta

Respuesta

​Autenticación

​Parámetros de ruta

​Parámetros de consulta

​Respuesta

Autenticación

Parámetros de ruta

Parámetros de consulta

Respuesta